Summary

• Add tests/lint-warnings.sh as a warning-level ShellCheck profile for the repository's Bash scripts, examples, libraries, and shared test helpers.
• Keep ./tests/validate.sh as the stable error-level validation gate while checking the new warning script for error-level ShellCheck issues.
• Document intentional ShellCheck exceptions near dynamic source paths, cross-file marker variables, BATS-compatible globals, and the supported-Bash re-exec path.

Issue

Fixes #93

Validation

• tests/lint-warnings.sh
• ./tests/validate.sh
• git diff --check origin/main...HEAD

Notes

• Refreshed the old ci/93-20260701-shellcheck-warning-profile branch onto current main and force-pushed with lease so the stale remote branch state is gone.